home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / tosfixes / fser096b.lzh / FSER096B / READ.ME < prev    next >
Text File  |  1993-08-08  |  14KB  |  356 lines
  1.  
  2. Fast_Ser
  3. ========
  4.  
  5. Fast_Ser ist ein erweiterter Treiber für serielle Schnittstellen 
  6. auf dem STE/TT/Falcon030.
  7. Für Modem/Serial 1 (MFP) ist eine erweiterte Rsconf-Auskunftsfunktion
  8. implementiert. Für Modem/Serial 2 (SCC) sind zusätzlich alle Bco...- 
  9. und Interrupt-Routinen neu (und hoffentlich fehlerfrei) implementiert, 
  10. und die Baudratentabelle ist mit eigenen Werten programmierbar.
  11.  
  12. Fast_Ser stellt eine Standardschnittstelle zur jeweiligen
  13. Hardware mit Hilfe der Rsconf-Funtion her.
  14.  
  15.  - Cookie 'FSER', zeigt auf Struktur FSER_INFO:
  16.     typedef struct
  17.     {
  18.         UWORD version;
  19.         unsigned unused:15;
  20.         unsigned baud_table_flag:1; /* bit 0 in einem word */
  21.         BASPAG *mem_blk;
  22.     } FSER_INFO;
  23.  
  24.  - Rsconf( -3, -2, xx, xx, xx, xx ) liefert 'FSER' als long
  25.     
  26.  - Rsconf( -3, -3, xx, xx, xx, xx ) liefert einen Pointer auf die
  27.     Struktur CHAN_INFO, die wie folgt definiert ist:
  28.     
  29.     typedef struct
  30.     {
  31.         BAUD_INFO *baud_table;
  32.         BAUD_INFO *alt_baud_table;
  33.         UBYTE **chip_address;
  34.         UWORD chip_type;
  35.         unsigned flags:14;
  36.         unsigned extrd_flag:1; /* bit 1 in einem word */
  37.         unsigned irq_flag:1;   /* bit 0 in einem word */
  38.         WORD task;
  39.         WORD resv[3];
  40.         ULONG dcd_on;
  41.         ULONG dcd_off;
  42.         UWORD rxbuffer_overflows;
  43.         UWORD framing_errs;
  44.         UWORD parity_errs;
  45.         UWORD charlost_errs;
  46.     } CHAN_INFO;
  47.  
  48.     typedef struct
  49.     {
  50.         LONG baudrate;
  51.         UWORD SCC_BRG_value;
  52.         UWORD SCC_MISC_value; /* bit 15..14 Clock mode (Reg. 4)
  53.                                  bit 9..8   BRG mode   (Reg. 14)
  54.                                  bit 6..3   Rx/Tx Clock Source (Reg. 11)
  55.                               */
  56.     } BAUD_INFO;
  57.     
  58.     baud_table: Zeiger auf die Tabelle mit den Baudrateninfos, in der 
  59.                 eine Null bei 'baudrate' das Ende markiert, -1 steht
  60.                 für eine nicht verfügbare Baudrate (nur bei den 
  61.                 ersten 16 Standardeinträgen!!), 
  62.                 -2 für einen freien Eintrag
  63.     alt_baud_table: wie baud_table, nur sind hier an den Indices
  64.                     0 und 1 höhere Baudraten eingefügt. Dadurch können
  65.                     auch Programme, die Fast_Ser nicht direkt unter-
  66.                     stützen, die höheren Baudraten nutzen 
  67.     chip_address: Hardwareadresse des Chips bzw. der internen
  68.                   Peripherie bei 68302, etc
  69.                   z.b $FFFF8C81 für Serial 2 auf MSTE/TT
  70.     chip_type: Welcher Chiptyp hängt an diesem Kanal dran?
  71.                $00: MFP
  72.                $10: Standard-SCC 8530
  73.                $11: VLSI-SCC VL85C30
  74.                $12: Zilog-SCC Z85C30
  75.                $13: AMD-ESCC Am85C30
  76.                $14: Zilog-ESCC Z85230
  77.                $15: AMD-ESCC Am85C230A
  78.                $20: ISDN-Coprozessor MC68302
  79.                $30: Ethernet-Coprozessor MC68EN360
  80.     flags: verschiedene bislang unbenutzte Flags
  81.     extrd_flag: Beim SCC ist in WR7' das ExtendedRead-Flag gesetzt.
  82.     irq_flag:   gesetzt: Die Interruptroutinen nutzen die SCC-FIFOS.
  83.     task: hier trägt eine Task, die die Schnittstellenhardware für 
  84.           sich haben will, ihre Nummer ein.
  85.           -1 steht für nicht reserviert.
  86.     dcd_on: letzter hz_200-Zeitpunkt, an dem DCD aktiv wurde
  87.     dcd_off: letzter hz_200-Zeitpunkt, an dem DCD inaktiv wurde
  88.     rxbuffer_overflows: Anzahl der Charakter, die bei einem vollem
  89.                         Empfangsbuffer verlorengingen
  90.     framing_errs: Anzahl der empfangenen Charakter mit Framing-Fehler
  91.                   (SCC-bedingt ein unsicherer Wert)
  92.     parity_errs:  Anzahl der empfangenen Charakter mit Parity-Fehler
  93.     charlost_errs: Anzahl der Charakter, die verlorengingen, weil der
  94.                    SCC nicht schnell genug abgefragt wurde
  95.                    (tatsächliche Anzahl kann größer sein!)
  96.  
  97. Bei den Standard-Clockraten für den SCC unterstützt Fast_Ser momentan
  98. folgende Baudratenliste (auf die alt_baud_table zeigt):
  99.  
  100. Listen für den MSTE/Falcon030
  101.  Kompatibilität im FSERIAL.CPX =AN:
  102.  Index:  Modem 2:     Serial 2:          Original:
  103.    0:    57600        57600              19200
  104.    1:    38400        38400              9600
  105.    2:    19200        19200              4800
  106.    3:    9600         9600               3600
  107.    4:    4800         4800               2400
  108.    5:    3600         3600               2000
  109.    6:    2400         2400               1800
  110.    7:    2000         2000               1200
  111.    8:    1800         1800               600
  112.    9:    1200         1200               300
  113.   10:    600          600                200
  114.   11:    300          300                150
  115.   12:    200          200                134
  116.   13:    150          150                110
  117.   14:    134          134                75
  118.   15:    110          110                50
  119.   16:    75           75
  120.   17:    50           50
  121.   18:    38400        38400
  122.   19:    57600        57600
  123.   20:    76800        115200
  124.   21:    153600
  125.  
  126.  Kompatibilität im FSERIAL.CPX =AUS:
  127.  Index:  Modem 2:     Serial 2:          Original:
  128.    0:    19200        19200              19200
  129.    1:    9600         9600               9600
  130.    2:    4800         4800               4800
  131.    3:    3600         3600               3600
  132.    4:    2400         2400               2400
  133.    5:    2000         2000               2000
  134.    6:    1800         1800               1800
  135.    7:    1200         1200               1200
  136.    8:    600          600                600
  137.    9:    300          300                300
  138.   10:    200          200                200
  139.   11:    150          150                150
  140.   12:    134          134                134
  141.   13:    110          110                110
  142.   14:    75           75                 75
  143.   15:    50           50                 50
  144.   16:    38400        38400
  145.   17:    57600        57600
  146.   18:    76800        115200
  147.   19:    153600
  148.  
  149.  
  150.  Liste für den TT:
  151.  Kompatibilität im FSERIAL.CPX =AN:
  152.  Index:  Modem 2:     Serial 2:          Original:
  153.     0:    38400        57600              19200
  154.     1:    76800        38400              9600
  155.     2:    19200        19200              4800
  156.     3:    9600         9600               3600
  157.     4:    4800         4800               2400
  158.     5:    3600         3600               2000
  159.     6:    2400         2400               1800
  160.     7:    2000         2000               1200
  161.     8:    1800         1800               600
  162.     9:    1200         1200               300
  163.    10:    600          600                200
  164.    11:    300          300                150
  165.    12:    200          200                134
  166.    13:    150          150                110
  167.    14:    134          134                75
  168.    15:    110          110                50
  169.    16:    75           75
  170.    17:    50           50
  171.    18:    38400        38400
  172.    19:    76800        57600
  173.    20:    153600       115200
  174.  
  175.  Kompatibilität im FSERIAL.CPX =AUS:
  176.  Index:  Modem 2:     Serial 2:          Original:
  177.     0:    19200        19200              19200
  178.     1:    9600         9600               9600
  179.     2:    4800         4800               4800
  180.     3:    3600         3600               3600
  181.     4:    2400         2400               2400
  182.     5:    2000         2000               2000
  183.     6:    1800         1800               1800
  184.     7:    1200         1200               1200
  185.     8:    600          600                600
  186.     9:    300          300                300
  187.    10:    200          200                200
  188.    11:    150          150                150
  189.    12:    134          134                134
  190.    13:    110          110                110
  191.    14:    75           75                 75
  192.    15:    50           50                 50
  193.    16:    38400        38400
  194.    17:    76800        57600
  195.    18:    153600       115200
  196.  
  197.  
  198. Bei einem Terminalprogramm (z.B. RUFUS) bedeutet das, daß man
  199. um eine Baudrate von 57600 auf Serial 2 zu erreichen, 19200 Baud
  200. auswählen muß (im Kompatibilitäts-Modus). Allerdings liegen die 
  201. hohen Baudraten